home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 September / Macworld (1997-09).dmg / Shareware World / Info / For Developers / DR2.1update3 / README.shared < prev    next >
Encoding:
Text File  |  1997-06-28  |  4.5 KB  |  126 lines  |  [BINA/hDmp]
  1. June 26, 1997
  2.  
  3. This README contains the instructions on installing the second part of
  4. DR2.1update3: the Shared Libraries and several packages based on those
  5. shared libraries.
  6.  
  7. Since Gary Thomas first made Shared Libraries and several packages available
  8. for MkLinux (and other PPC-based Linuxes), many people have tested them,
  9. used them in "production environments", and even rebuilt more packages
  10. linked with the shared libraries.  This update does not attempt to provide
  11. _all_ the shared-library-based packages currently available.  (Most notably,
  12. there are no Xwindows packages in this update).  The packages in this update
  13. represent a "core set" of a shared-library-based MkLinux installation.
  14. After you install these packages, you may install any of the shared-library-
  15. based packages that are out there.  However, for the more conservative
  16. MkLinux user, we will be distributing more of these packages in future
  17. updates to MkLinux DR2.1.
  18.  
  19.  
  20. Prerequisites
  21. -------------
  22.  
  23. You should complete the first part of DR2.1update3 before installing the
  24. shared libraries.  Instructions for this are in the file README.install.
  25. Reboot your MkLinux machine after you've installed the new Microkernel,
  26. Linux Server, and Default Pager.
  27.  
  28.  
  29. Obtaining the packages and installation script
  30. ----------------------------------------------
  31.  
  32. There are dozens of methods for getting the packages and scripts onto
  33. your MkLinux system.  However, the goal is to create a directory structure
  34. somewhere in your MkLinux filesystem that is similar to the directory
  35. structure under DR2.1update3 on the ftp site ftp.mklinux.apple.com (and
  36. its mirrors).
  37.  
  38. In a nutshell, you want to have a directory containing the file
  39. "install_shlibs".  Also in that directory, you should have another
  40. directory "RPMS".  In the RPMS directory you should have another
  41. directory called "ppc".  In that ppc directory, you will have all the
  42. RPM packages.  They all will have the suffix ".ppc.rpm".
  43.  
  44. (top)---+
  45.         |
  46.         +install_shlibs
  47.         |
  48.         +RPMS---+
  49.                 |
  50.                 +ppc----+package1.ppc.rpm
  51.                         +package2.ppc.rpm
  52.                         +package3.ppc.rpm
  53.  
  54.                         .
  55.                         .
  56.                         .
  57.  
  58. One way to get the files into this structure is to use ftp directly
  59. from MkLinux:
  60.  
  61. # mkdir update3
  62. # cd update3
  63. # mkdir RPMS
  64. # mkdir RPMS/ppc
  65. # ftp ftp.mklinux.apple.com        (use anonymous FTP, as usual)
  66. > cd /pub/Updates/DR2.1update3        (cd to the top of DR2.1update3)
  67. > get install_shlibs            (get the install script)
  68. > lcd RPMS/ppc                (change local directory)
  69. > cd RPMS/ppc                (change remote directory)
  70. > prompt                (turn off prompting)
  71. > mget *                (retrieve all the .ppc.rpm's)
  72. > quit
  73.  
  74. Set install_shlibs to be executable:
  75.  
  76. # chmod +x install_shlibs
  77.  
  78. You should now have the correct directory structure for installing
  79. the shared libraries.
  80.  
  81. There are many other ways to obtain these files and get them onto
  82. your MkLinux filesystem.  One method would be to use a MacOS based
  83. FTP client (such as Fetch), then use either LinuxDisks or the HFS
  84. Utils (under MkLinux) to move the files over to the Mklinux Filesystem.
  85. There is more information on these tools in the file README.install.
  86. Whichever method you choose, just mimic the directory structure shown above
  87. and you should be ready to proceed.
  88.  
  89.  
  90. Backup all your data
  91. --------------------
  92. You should save any files on your MkLinux system that are important to you.
  93. Naturally, we try to make this update as "safe" as possible.  However, it
  94. _is_ possible that this procedure could ruin your current MkLinux
  95. installation beyond repair.
  96.  
  97.  
  98. Run the installation script
  99. ---------------------------
  100.  
  101. Run the script as root.  Make sure there are no other users on the system
  102. when you perform the update.  Run the script from the directory it's in.
  103.  
  104. # ./install_shlibs
  105.  
  106.  
  107. The script will check to see that all the necessary RPM packages are
  108. where they belong, and then continue with the installation.  There is
  109. one question you will need to answer in the script, regarding whether
  110. you want to proceed.
  111.  
  112. Once the installation has completed, you will need to forcibly reboot
  113. your machine.  This can be done by pressing the keys control-command-power
  114. all at the same time.  The regular rebooting mechanism (shutdown -r or
  115. reboot) will not work this one time as those programs have been changed
  116. in the installation.  After you reboot your machine, the "shutdown" command
  117. will work properly.
  118.  
  119.  
  120. Cleanup
  121. -------
  122.  
  123. Once the packages have been installed, it is not necessary for you to
  124. keep them around.  If you want, you may delete the ".ppc.rpm" files
  125. to recover the disk space.
  126.